Expandable Property, SftTreeItem Object


	SftTreeItem.Expandable Property	Softel vdm, Inc.

Defines whether the item is expandable.

Syntax

Get
	VB.NET	Boolean = object.Expandable As Boolean
	VB	Boolean = object.Expandable As Boolean
	C#.NET	bool Boolean = object.Expandable;
	VC++	VARIANT_BOOL Boolean = object->Expandable; VARIANT_BOOL Boolean = object->GetExpandable();
	C	HRESULT object->get_Expandable(VARIANT_BOOL* Boolean);
	Delphi	Boolean := object.Expandable : WordBool;
Put
	VB.NET	object.Expandable = Boolean As Boolean
	VB	object.Expandable = Boolean As Boolean
	C#.NET	bool object.Expandable = Boolean;
	VC++	VARIANT_BOOL object->Expandable = Boolean; void object->PutExpandable(VARIANT_BOOL Boolean);
	C	HRESULT object->put_Expandable(VARIANT_BOOL Boolean);
	Delphi	object.Expandable := Boolean : WordBool;

object

A SftTreeItem object.

Boolean

Defines whether the item is expandable.

Boolean	Description
True	The item is expandable.
False	The item is not expandable.

Comments

The Expandable property defines whether the item is expandable.

Normally, only a parent item (with dependents) is expandable. An expandable item displays an expand/collapse button and other attributes, such as the Items.ItemImageExpandable graphic.

A leaf item can be made a “temporary” parent item by setting the item's Expandable property to True. The item now displays an expand/collapse button and other attributes, such as the Items.ItemImageExpandable graphic. The item can now also generate an ItemClick event to expand the item. The application can then add child items as the user expands this “temporary” parent item, making it into a real parent item.

When setting the Expandable property, an item's dependents are always removed, unless the item is already expanded.

If an item's Expandable property is set to False, the item is collapsed (and its dependents are removed).

If an item is already expanded or has dependents when setting Expandable to True, the item remains unchanged. It is not expanded.